.TH stoker_copy 8 "5 September 2008" "version 0.91" "Stoker Manual"
.SH NAME
stoker (copy) \- remote file copy
.SH SYNOPSIS
.B stoker
[OPTIONS] <machine(s)> copy [options] <source> [source2 [...]] <dest>

.B stoker
<\-a | \-\-all> [OPTIONS] copy [options] <source> [source2 [...]] <dest>
.SH DESCRIPTION
The stoker(8) copy command copies one or more files to a destination path
on each remote target, using scp(1).
If more than one source file is specified, <dest> MUST be a directory name
on the remote host(s).
Global OPTIONS, including selection of parallel operation, are documented
in the man page for stoker(8).
.SH COMMAND OPTIONS
.TP
.B \-p \-\-preserve\-mode
Preserve file creation time, modification time, and permissions.
.TP
.B \-r \-\-recursive
Recursively copy subdirectories
.SH EXAMPLES
.TP
Copy /etc/fstab to /etc/fstab on host1 and host2:
stoker host1,host2 copy /etc/fstab /etc
.TP
Distribute /root/message as /etc/motd on all known hosts:
stoker -a copy /root/message /etc/motd
.SH EXIT STATUS
Stoker returns a zero exit status if all copy operations succeed.
If one or more copy operations fails, a non-zero exit status will be returned.
.SH SEE ALSO
scp(1), stoker(8)
.SH AUTHOR
Mike Murphy (mamurph@cs.clemson.edu)
.SH DISCLAIMER
This material is based upon work supported under a National Science
Foundation Graduate Research Fellowship.
Any opinions, findings, conclusions or recommendations expressed in this
publication are those of the author(s) and do not necessarily reflect the
views of the National Science Foundation.
